package com.darling.danotebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.darling.danotebackend.model.dto.picture.*;
import com.darling.danotebackend.model.dto.vo.PictureVO;
import com.darling.danotebackend.model.entity.Picture;
import com.baomidou.mybatisplus.extension.service.IService;
import com.darling.danotebackend.model.entity.User;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * @author zheng
 * @description 针对表【t_picture(图片)】的数据库操作Service
 * @createDate 2025-02-13 22:36:38
 */
public interface PictureService extends IService<Picture> {

    /**
     * 上传图片
     *
     * @param inputSource          输入源
     * @param pictureUploadRequest 图片上传请求
     * @param loginUser            登录的用户
     * @return PictureVO
     */
    PictureVO uploadPicture(Object inputSource, PictureUploadRequest pictureUploadRequest, User loginUser);

    /**
     * 将查询请求转为 QueryWrapper 对象
     *
     * @param pictureQueryRequest pictureQueryRequest
     * @return QueryWrapper 对象
     */
    QueryWrapper<Picture> getQueryWrapper(PictureQueryRequest pictureQueryRequest);

    /**
     * 编写获取图片封装的方法，可以为原有的图片关联创建用户的信息
     *
     * @param picture 图片
     * @param request 请求
     * @return 获取图片封装
     */
    PictureVO getPictureVO(Picture picture, HttpServletRequest request);

    /**
     * 分页获取图片封装
     *
     * @param picturePage 图片
     * @param request     请求
     * @return 获取图片封装
     */
    Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request);

    /**
     * 图片数据校验方法，用于更新和修改图片时进行判断
     *
     * @param picture 预校验的图片
     */
    void validPicture(Picture picture);


    /**
     * 图片审核
     *
     * @param pictureReviewRequest pictureReviewRequest
     * @param loginUser            当前登录用户
     */
    void doPictureReview(PictureReviewRequest pictureReviewRequest, User loginUser);

    /**
     * 填充审核参数
     *
     * @param picture   图片状态
     * @param loginUser 当前登录用户
     */
    void fillReviewParams(Picture picture, User loginUser);

    /**
     * 批量抓取和创建图片
     *
     * @param pictureUploadByBatchRequest 批量抓取图片请求
     * @param loginUser                   当前登录用户
     * @return 成功创建的图片数
     */
    Integer uploadPictureByBatch(PictureUploadByBatchRequest pictureUploadByBatchRequest, User loginUser);

    /**
     * 删除图片
     *
     * @param pictureId 欲删除的图片 id
     * @param loginUser 当前登录用户
     */
    void deletePicture(long pictureId, User loginUser);

    /**
     * 编辑图片
     *
     * @param pictureEditRequest 图片编辑请求
     * @param loginUser          当前登录用户
     */
    void editPicture(PictureEditRequest pictureEditRequest, User loginUser);

    /**
     * 清理图片文件
     *
     * @param oldPicture oldPicture
     */
    void cleanPictureFile(Picture oldPicture);

    /**
     * 校验空间图片的权限
     *
     * @param loginUser 当前登录用户
     * @param picture   图片
     */
    void checkPictureAuth(User loginUser, Picture picture);

    /**
     * 根据颜色搜索图片
     *
     * @param spaceId   空间 id
     * @param picColor  图片颜色
     * @param loginUser 当前登录用户
     * @return 图片列表
     */
    List<PictureVO> searchPictureByColor(Long spaceId, String picColor, User loginUser);

    /**
     * 批量编辑图片
     *
     * @param pictureEditByBatchRequest 批量编辑图片请求
     * @param loginUser                 当前登录用户
     */
    void editPictureByBatch(PictureEditByBatchRequest pictureEditByBatchRequest, User loginUser);


}
